home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 February / EnigmA AMIGA RUN 15 (1997)(G.R. Edizioni)(IT)[!][issue 1997-02][PLANET CD V].iso / enigma / earcd / comm / comm2 / chkmc201.lha / ChkCD.doc < prev   
Text File  |  1997-01-07  |  4KB  |  93 lines
  1. ChkCD  Aminet CD checker by Gnome.
  2. ====================================
  3.  
  4. Purpose:
  5.  
  6.  Scans an Aminet CD TREE and INDEX & compares with actual dirs & files
  7.  on the CD. Reports Directories in TREE which don't exist or are empty.
  8.  Reports files in INDEX which don't exist.
  9.  
  10. Usage: ChkCD [f/?]
  11.  
  12.         f  causes report to be also written to ram:CDcheck
  13.         ?  displays purpose & usage of program
  14.  
  15. Examples: ChkCD         shows report on CLI window only
  16.  
  17.           ChkCD f       shows report on screen and on file ram:CDcheck
  18.  
  19.           ChkCD ?       only shows purpose & usage.
  20.  
  21. General:
  22.  
  23. The Aminet CD should be loaded in drive CD0:
  24.  
  25. The program will look for CD0:aminet/TREE and CD0:aminet/INDEX. If either
  26. of these is not found, the program will abort.
  27.  
  28. The program first identifies the CD name, and displays this as a heading.
  29.  
  30. The TREE file is then scanned, and any directory name in this file which
  31. does not exist on the CD will be listed in the output. Also each existing
  32. directory is examined, and if it does not contain an "Index" file, it is
  33. deemed to be an empty directory. (See footnotes 1,2)
  34.  
  35. The INDEX file is then scanned, and each file listed is checked that it
  36. does exist with the same path & name as in the index.  (Footnote 3) During
  37. the index scan, a progress bar window appears with a 'STOP' gadget in it.
  38.  
  39. The program may be stopped by clicking on the STOP button, or on the close
  40. gadget of the progress window, or by pressing Ctrl-C in the CLI.  This will
  41. close (not pause) the program, and any open files wil be closed and
  42. allocations freed.
  43.  
  44. The program is entirely safe to use, and the only writing it can do is to a
  45. report file in RAM.  It has been tested with Enforcer, Codewatcher and
  46. Mungwall.
  47.  
  48. A scan of Aminet16 took 8.5 minutes on my A4000 with 68040 processor.
  49.  
  50. ------------------------------------------------------------------------
  51.  
  52. Footnotes:
  53.  
  54. 1. It is common to find non-existent directories in Aminet CDs.
  55.  
  56. 2. Aminet directories have been found always to have an Index file, even
  57.    if the directory only holds one archive file.
  58.  
  59. 3. There are several INDEX files on an Aminet CD. The one used is
  60.    Aminetnn:aminet/INDEX. The one in the root directory is in guide format.
  61.  
  62. 4. There are cases where a file may be reported as not existing. This
  63.    happens when a file name is too long for the field allocated for names
  64.    in the Index. Example: "Just_Another_Affai" appears in the index to
  65.    Aminet16. This name is not in any CD directory, but
  66.    "Just_Another_Affair.lha" does exist. Since the name was chopped, it
  67.    cannot be found.
  68.  
  69.    There have also been a few cases on earlier CDs where a name was either
  70.    chopped or currupted in the index, or the file was indeed missing.
  71.  
  72. 5. ChkCD does not work on the first Aminet CD (Aminet_0693) because
  73.    INDEX and TREE are in a different place on the CD. The 2nd CD
  74.    (Aminet_0294) has 1 missing directory and many "missing files".
  75.  
  76.  
  77. Credits:
  78.  
  79. Thanks to Tom Bampton, who wrote 'Progress_Bar', for his useful coding and
  80. example.  I have not in fact used this, but I learned a lot from it.
  81.  
  82. Thanks also to numerous folk who replied to my question in the usenet
  83. newsgroup comp.sys.amiga.programmer, asking "How do I program a progress
  84. bar?" Their information and encouragement contributed to the success of
  85. 'ChkCD'.
  86.  
  87.  -------------------------------------------------------------------
  88.  John Marchant ('Gnome'). Bedford UK.            gnome@mag-net.co.uk
  89.  Amiga 4000/40                                  Fidonet 2:257/137.16
  90.  Moonlight (Amiga) BBS. 6pm-8am (ONLY)  +44 1234 212752
  91.  Fax, Fido freq, Fido netmail accepted during open hours.
  92.  -------------------------------------------------------------------
  93.